package cn.iocoder.yudao.module.reading.service.category;

import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.reading.controller.admin.category.vo.CategoryCreateReqVO;
import cn.iocoder.yudao.module.reading.controller.admin.category.vo.CategoryPageReqVO;
import cn.iocoder.yudao.module.reading.controller.admin.category.vo.CategoryUpdateReqVO;
import cn.iocoder.yudao.module.reading.dal.dataobject.category.CategoryDO;

import jakarta.validation.Valid;
import java.util.List;

/**
 * 绘本分类 Service 接口
 *
 * @author 芋道源码
 */
public interface CategoryService {

    /**
     * 获得启用的分类列表
     *
     * @return 分类列表
     */
    List<CategoryDO> getActiveCategories();

    /**
     * 根据语言获得启用的分类列表
     *
     * @param language 语言类型
     * @return 分类列表
     */
    List<CategoryDO> getActiveCategoriesByLanguage(String language);

    /**
     * 获得分类
     *
     * @param id 编号
     * @return 分类
     */
    CategoryDO getCategory(Long id);

    /**
     * 根据名称获得分类
     *
     * @param name 分类名称
     * @return 分类
     */
    CategoryDO getCategoryByName(String name);

    // ==================== Admin 管理相关 ====================

    /**
     * 创建分类
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createCategory(@Valid CategoryCreateReqVO createReqVO);

    /**
     * 更新分类
     *
     * @param updateReqVO 更新信息
     */
    void updateCategory(@Valid CategoryUpdateReqVO updateReqVO);

    /**
     * 删除分类
     *
     * @param id 编号
     */
    void deleteCategory(Long id);

    /**
     * 获得分类分页
     *
     * @param pageReqVO 分页查询
     * @return 分类分页
     */
    PageResult<CategoryDO> getCategoryPage(CategoryPageReqVO pageReqVO);

}
